Hexo 下的 MarkDown 渲染插件

Hexo 内置的默认渲染插件是 hexo-renderer-marked,缺少很多功能,比如不支持 GFM、上下标、emoji 等。目前在用的是:hexo-renderer-markdown-it-plus [1]

hexo-renderer-markdown-it[2]

支持大量扩展功能,对我而言,最重要的就是它的 footnote 插件

安装[3]

先卸载自带的 hexo-renderer-marked,再安装

配置[4][5]

在站点根目录下的 _config.yml进行配置

1
2
3
4
5
6
7
8
9
10
11
12
# 示例
# Markdown-it config
## Docs: https://github.com/celsomiranda/hexo-renderer-markdown-it/wiki
markdown:
render:
html: true
plugins:
- markdown-it-abbr
- markdown-it-footnote
anchors:
level: 2
collisionSuffix: 'v'

hexo-renderer-markdown-it-plus[1:1]

hexo-renderer-markdown-it 的“升级”版,在原来基础上增加了一些插件,并且支持第三方 markdown-it 插件。推荐使用这个

安装和配置和 hexo-renderer-markdown-it 类似,详情请看官方主页[1:2]

其他注意事项

如果你想测试效果,则记得先使用 hexo clean 命令清除一下缓存,不然有可能看不到效果,以为自己安装错误……(别问我怎么知道的 😢)

注脚


  1. CHENXCHEN/hexo-renderer-markdown-it-plus: Markdown-it is a markdown parser, done right. A faster and CommonMark compliant alternative for Hexo. #主页 ↩︎ ↩︎ ↩︎

  2. hexojs/hexo-renderer-markdown-it: Markdown-it is a Markdown parser, done right. A faster and CommonMark compliant alternative for Hexo. #主页 ↩︎

  3. Getting Started · hexojs/hexo-renderer-markdown-it Wiki ↩︎

  4. Simple Configuration · hexojs/hexo-renderer-markdown-it Wiki ↩︎

  5. Advanced Configuration · hexojs/hexo-renderer-markdown-it Wiki ↩︎